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No part of this publication mav be reproduced, transmitted, 
transcribed, stored in a retrieval system, or translated into 
any language or computer language. in any form or bv anv 
means, electronic, mechanical, magnetic, optical. chemical, 
manual or otherwise, without the prior written permission of 
Digital Research, Post Office Box 579, Pacific Grove, 
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Digital Research makes no representations or warranties with 
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implied warranties of merchantability or fitness for any parti- 
cular purpose. Further, Digital Research reserves the right 
to revise this publication and to make changes from time to 
time in the content hereof without obligation of Digital 
Research to notify anv person of such revision or changes. 
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1. AN OVERVIEW OF CP/M 2.6 FACILITIES. 
\ CP/M 2.0 is a high-performance single-console operating system 
jwhich uses table driven tecnniques to allow field reconfiguration to 
match a wide -ariety of disk capacities. All of the fundamental file 
restrictions are removed, while maintaining upward compatibility from 
previous versions of release l. Features of CP/M 2.0 include field 
specification of one to sixteen logical drives, eacn containing up to 
eight megabytes. Any particular file can reacn the full drive size 
with the capability to expand to thirty-two megabytes in future 
releases, The directory size can be field configured to contain any 
reasonable number of entries, and each file is optionally tagged with 
read/only and system attributes. Users of CP/M 2.9 are physically 
separated by user numbers, with facilities for file copy operations 
from one user area to another, powerful ielative-record random access 
- functions are present in CP/M 3. g which ra direct access to any 
of the 65536 records of an eight megabyte file | 


| . All .disk-dependent portions of CP/M 2.8 are placed into a 
BIOS-resident “disk parameter plock" which is either hand coded or 
produced . automatically using the disk definition .macro library 
provided with CP/M 2.0. The end user need only specify the maximum 
number of active disks, the starting and ending sector numbers, the 
data allocation size, the maximum extent of the logical disk, 
directory size ig neiakeiep and reserved track values. The macros use 
this information - /generate: -the- appropriate tables and table 
references for use pepe CP/M 2.9 operation. Deblocking information 
yim, 1s.also: provided. wnich aids in assembly or disassembly of sector sizes 
‘(mm which are multiples of tne fundamental 128 byte data unit, and the 
| system- - alteration... ‘Manual includes general-purpose subroutines wnich 


~~ ae) -_ > ~ 


. use the this deplocking information to take advantage of larger sector 
~  sizes.. Use of. these subroutines, togetner with the table driven data 
access” algoritnms, make CP/M 2.8 truly a universal data management 
a, SYSCOM Sc 2 tS ete a 

.. File expansion is achieved by providing up to 512 logical file 
extents, where eacn logical extent contains 16K bytes of data. CP/M 

2.@ is: structured, nowever, so that as much as 128K bytes of data 15 

ae addressed by a single physical extent (corresponding to a single 
= directory -entry), tnus maintaining compatibility with orevious 

versions while pened ‘ete advanced? of directory space, : 


ee 


Random access ee are present in CP/M 2.0 which allow 
-immediate. reference: to any record of an eight megabyte file. Using 
CP/M’s unique data organization, data blocks are only allocated when 
actually required and movement to a record position requires little 
search time. Sequential file access is upward compatible from earlier 
versions to the full eight megaoytes, while random access 
compatibility stops at 512K byte files. Due to CP/M 2.8's simvler and 
faster random access, application programmers are encouraged to alter 
their programs to take full advantage of the 2.0 facilities. 


Several CP/M 2.8 modules and utilities have improvements which 
am. COrrespond to the enhanced file system. STAT and PIP both account for. 
jfile attributes and user areas, while the CCP provides a “login” 
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Additional 


Function to change from one user area to another. The CCP also 


formats directory displays in a more convenient manner and accounts 
for poth CRT and hard-copy devices in its enhanced line editing 
-£functions, | : 
: 

The séestions below point out the individual differences between 


CP/M 1.4 and CP/M 2.9, with the understanding that the reader is 
either familiar with CP/M 1.4, or has access to the 1.4 manuals. 
information dealing with CP/M 2.8 _ system alteration is 
presented in the Digital Research manual “CP/M 2.9 Alteration Guide." 
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2. USER INTERFACE. 


sau Console line processing takes CRT=-type devices into account with 

three new control characters, shown with an asterisk in the list pdelow 

m/ (the symbol "ctl" below indicates that the control key is 
Simultaneously depressed): 7 | 


rub/del removes and echoes last character 

ctl-C reboot when at beginning of line 

ctl-E physical end of line | | 

Ctl-H backspace one cnaracter position* 

ctl-J (line feed) terminates current input* 
ctl-M (carriage return) terminates input | 
ctl-R retype current line after new line 
ctl-U remove current line after new line _ 
ctl-X backspace to beginning of current line* 


In particular, note that ctl-H produces the proper backspace overwrite 
function (ctl-H can be changed internally to another character, such 
as delete, through a simple single byte change). Further, the line 
editor keeps track of the current prompt column position so that the 
operator can properly align data input following a ctl-U, ctl-R, or 
ctl-X command. | — | 
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3% CONSOLE COMMAND PROCESSOR (CCP) INTERFACE, 


There are four functional differences between CP/M 1.4 and CP/M 
2.6 at the console command processor (CCP) level. The CCP now > 


displays directory information across the screen (four elements per : "\ 


line), the USER command is present to allow maintenance of separate 
files in the same directory, and the actions of the “ERA *.*" and 
“SAVE” commands have changed. . The altered DIR format is 
self-explanatory, while the USER command takes the form: , 


USER n 
where n is an integer value in the range 8 to 15% Upon cold start, 
the operator is automatically “logged” into user area number 9, which 
is compatible with standard CP/M 1.4 directories. The operator may 
issue the USER command at any time to move to anotner logical area 
within the same directory. Drives which are logged-in while 


addressing one user number are automatically active when the operator 
moves to another user numper since a user number is simply a prefix 
which accesses particular directory entries on the active disks. 


The active user number is maintained until changed by a. 
subseguent USER command, or until a cold start operation when user §@ 


is again assumed, 


Due to the fact that user numbers now _— Paredes aareeeary: 
entries, ‘the ERA *.* command has a different effect. In version 1.4, 
this command can be “used to erase a directory whicn has “garbage” 


\ , information, | perhaps resulting from use of a diskette under another | 
Operating system (heaven forbid!). In 2.9, however, the ERA *,.* _ 4 
command affects only the current user number. Thus, it is necessary 


to write a simple utility to erase a nonsense disk (the program simply 
writes the hexadecimal pattern E5 throughout the disk). 


The SAVE command in version 1.4 allows only a single memory save 


re nd with the potential of destroying the memory image due to 
directory operations following extent boundary changes. Version 2.4, 


nowever, does not perform directory operations in user ‘data areas 
after disk writes, and thus the SAVE operation can be used any number 
of ‘times without altering the saci image, 
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4, STAT ENHANCEMENTS. 


The STAT program has a number of additional functions which 
allow disk parameter display, user number display, and file indicator 
manipulation. The command: 


STAT VAL: 


produces a summary of the available status eemmanes, resulting ins the 
output: 


Temp R/O Disk: d:=R/0 

‘Set Indicator: d:filename.typ $R/O SR/wW SSYS SDIR 
Disk Status : DSK: d:DSK: 

Oser Status : USR: 

Iobyte Assign: 

(list of possible assignments) 


whicn gives an instant summary of the possible STAT commands. The 
command forms: a 
STAT d:filename.typ $S 


wnere “d:" is. an optional drive name, and “filename.typ"’ is = an 
unambiguous or ambiguous file ‘name, produces the output display 


-format: | 
Size Recs Sytes Ext Acc | - 
48 48 6k 1 R/O A:ED.COM 
55 55 12k 1 R/O (A:PIP.COM) 
So ee.. 128 2k 2. R/W A:X.DAT 


- + ee 


, whete. ‘tne SS parameter causes the “Size" field £0 oe displayed 


(without the $S, the Size field is skipped, but the remaining fields 
are displayed). The Size field lists the virtual file size in 
records, while the “Recs" field sums the number of virtual records in 
each extent. For files constructed seguentially, the Size and Recs 
fields are identical. The “Bytes” field lists the actual number of 
bytes allocated to the corresponding file, The minimum allocation 
unit is determined at configuration time, and thus tne number of bytes 


_ corresponds to the record count plus the remaining unused space in the 


last allocated block for sequential files, Random access files are 
given data areas only when written, so the Bytes field contains the 
“Only accurate allocation figure. In the case of random access, the 
Size field gives the logical end-of-file record position and the Recs 
field counts the logical records of each extent (each of these 


~ extents, however, may contain unallocated “holes" even though they are 


added into the record count). The “Ext" field counts the number of 
logical 16K extents allocated to the file. Unlike version 1.4, the 
Ext count does not necessarily correspond to the number of directory 
entries given to the file, since there can be up to 128K pytes (8 


- logical extents) directly addressed by a single directory entry, 


depending upon allocation size (in a special case, there are actually 
256K bytes which can be Bienes addressed by a physical extent). 


The "Acc" field gives the R/O or R/W ‘access mode, which is 


“, changed using the commands shown pdelow. Similarly, the parentheses 
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; : | | Bdos Ere on d: File R/O 


Di ee ee etd |. STAT d:DSK: 


oe ee A oe = ee ee oe . i: cme =. oe o 1s oo ome em 


Shown around the PIP.COM file name indicate that it has the “system” 
indicator set, so that it will not be listed in DIR commands. The 


four command forms 


STAT d:filename.typ $R/O 
STAT d:filename.tyo $2/W 
STAT d:filename.typ SSYS 
STAT d:filename.tyo SDIR 


set or reset various permanent file indicators. The R/O indicator 
places the file (or set of files) in a read-only status until changed 
by a subsequent STAT command. The R/O status is recorded in the 
directory with tne file so that it remains R/O through intervening 
cold start operations. The R/W indicator places the file in a 
permanent read/write status. The SYS indicator attaches the system 


indicator to the file, while the DIR command removes the system . 


indicator. The “filename.typ" may be ambiguous or unambiguous, but in 
either case, the files whose attributes are changed are listed at the 
console when the enangs occurs, The drive name denoted by “d:" is 
optional. ae 


When a file is marked R/O, subsequent attempts to erase or write 
into the file result ina terminal BDOS message - 


The BDOS then waits for a console input before performing a subsequent 


warm start (a “return” is sufficient to CONE SOUE) « The command form 


‘lists hive aeige Characteristics of the disk named by “d:“ which is in 


the range A:, Bs, ..., P:. The drive characteristics are listed in 
the formats: : : 


d: Drive Cnaracteristics 
| 65536: 128 Byte record Capacity 
sd 8192s Kilobyte Drive Capacity 
m | 128: 32 Byte Directory Entries 
@: Checked Directory Entries 
1924: Records/ &xtent 
128; Records/ Block 
58: Sectors/ Track 
2: Reserved Tracks 


where “d:“ is the selected drive, followed by the total record 
capacity (65536 is an 8 megabyte drive), followed by the total 
Capacity listed in Kilobytes. The directory size is listed next, 
followed by the “checked“ entries. The number of checked entries is 


usually identical to the directory size for removable media, since. 


this mechanism is used to detect changed media during CP/M operation 
without an intervening Warm start. For £1xéd media, the number is 
usually zero, since the media is not changed without at least a cold 
Or warm start. The number of records per extent determines the 
addressing capacity of each directory entry (1624 times 128 bytes, or 
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128K in the example above). The number of records ver block shows the 

basic allocation size (in'the example, 128 records/block times 128 

. bytes per record, or 16K bytes per block). The listing is then 

=) followed by the number of physical sectors per track and the number of 

‘reserved tracks. For logical drives which share the same physical 

disk, the number of reserved tracks may be quite large, since this 
mechanism is used to skip lower=numbered disk areas allocated to other 
logical disks. ‘The command form 


STAT DSK: 


produces a drive characteristics table for all currently active 
drives, The final STAT command form is | 


STAT USR: | 


which produces a list of the user numbers which have files on the 
Currently addressed disk, The display format is: 


Active User : @ 
Active Files: 9 l1 3 


where the first line lists the currently addressed user number, as set 

by the last CCP USER command, followed by a list of user numbers 

scanned from the current directory. In the above case, the active 

user number is.J (default at cold start), with three user- numbers 

which have active files on the current disk. The operator can 

_ Subsequently examine the directories of the other user numbers by 

fae, Logging-in with USER 1, USER ae or USER 3 eee followed oe a DIR 
yeoman at the CCP level. 


jae ae 
(@, & 
LU 
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25% PIP ENHANCEMENTS, 


=. PIP provides three new functions which account for the features 
_.O£f CP/M 2.90. All three functions take the form of file parameters 


:which are enclosed in square brackets following the appropriate file 8 


-hames, - The commands are: 


a 7. Gn Get File from User number n 
| (nm in the range § = 15) 
| W Write over R/O files without 
Oroce sas | , console interrogation 
-~- R -- Read system files 


WAsSSuming- the operator has issued the USER 4 command at the CCP level, 
ctheePIP’ statement 


a 


- 


po 7 PIP X.Y = X.Y[G2] 
reads file X.Y from user number 2 dinto user area number 4, The 
 yweonmand: | | | 
by the Leste | PIP A:=A:* -*[G2] 
Scannec i:: 


 useples:ali of the files from the A drive dercscons: for user number 2 
whato the A drive directory of the currently logged user number. Note 

sthat-to- ensure file security, one cannot copy files into a different 

iarea:than the one which is | addressed by the USER command. 


“Note also that the PIP program itself 1S initially eonited to a 
user area (so that subsequent files can be copied) using the SAVE 


command. The sequence of operations shown below Screen moves PIP 
from one user area to the next. 


USER 0 | Souea user g 
DOT PIP.COM load PIP to memory 
a 44 (note PIP size s) | 
oes GO | return to CCP ee ee 
“ Oe OSER 3 login user 3. ee 


SAVE s PIP.COM 


where s is the integral number of memory “pages” (256 byte segments) 


occupied by PIP. The number s can be determined when PIP.COM is - 


loaded under DDT, by referring to the value under the "NEXT" display. 
If for example, the next available address is 1D04, then PIP.COM 
requires 1C hexadecimal pages (or 1 times 16 + 12 =. 28 pages), and 
thus the value of s is 28 in the subsequent save. Once PIP is copied 


‘in this manner, it can then be copied to another disk belonging to the. 


‘same user number through normal pip transfers, 


Under normal operation, PIP will not overwrite a file which is 


set tO a permanent R/O status. If attempt is made to overwrite a R/O 
file, the prompt : | | 
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SS 


The G command allows one user area to receive data files from another. ~— 


<2. 


Nee ae oe FILE IS R/O, DELETE (Y/N)? 


is issued. If the operator responds with the character “y“ then the 
file is overwritten. Otherwise, the response 


** NOT DELETED ** 
is issued, the file transfer is skippped, and PIP continues with the 
next operation in sequence. In order to avoid the prompt and response 
in the case of R/O file overwrite, the command line can include the W 
parameter, as shown below 


PIP ats aint 


which copies all non~system files to.the A drive from the B drive, and 
overwrites any R/O files in the process. If the operation involves .. 


Several concatenated files, the w parameter need only be included with 
the last file in the list, as shown in the following example 


PIP A.DAT = B.DAT, F:NEW.DAT,G:OLD. DAT [W] 


Files with the system attribute can be included in PIP transfers 
if the R parameter is included, otherwise system files are not 
recognized, The command line — 


~ 


PIP ED.COM = B:ED,COM[R] | — 


for example, reads the ED.COM file from the B drive, even if it has 


(o been marked as a R/O and a baka file. The system file attributes are 
wey copied, , if present. --.. pega, ee Se eee ON 


It should be noted that downward compatibility with previous 
versions of CP/M is only maintained if the file does not exceed one 


megabyte, no file attributes are set, and the file is created by user 


Q. Tf compatibility is required with non-standard (e.g., “double 
density”) versions of 1.4, it may be necessary to select 1.4 
compatibility mode when constructing the internal disk parameter block 
(see the “CP/M 2.8 Alteration Guide," and refer to Section 19 which 
describes BIOS differences). 
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6. ED ENHANCEMENTS. = -1.i):. 


: .=+.Phe CP/M standard orogram editor provides several new facilities 
-in the 2.8 release, Experience has shown that most operators use the 
relative line numbering feature of ED, and thus the editor has the “v" 
(Verify Line) option set as an. initial value. The operator can, of 
course, disable line numbering by typing the “-v" command. If you are 
~hot: familiar with the ED line number mode, you may wish to refer to 
n€he -Appendix in the- ED user's. uae: where the "“v" command is 


Lad@scribed:. .2 # 2 eos Syste. Soe Seress seek. 
DPaelaine tei. 25 E25 .. 
ED also eakce: tile attributes into account. . If the operator 


attempts to edit a read/only file;«the message 


-Whicr COnies ee. non=svs8@-:PILE<ES: eee oe. 3a, Se = pee 
“es = Bo es - : 


- ~~ -— = ar al eee »- > . aw see 


OVErWwILICs em 


a er 


sappearscat- cher ongole 2 the. fike: can: “ebe: ‘toaded- and> examined, but 
teannet: be-altered:in any ways 7.<Normally, the .operator simply ends the 


edit session, and uses STAT to change the file attribute to R/W. Tf 
the edited filé@ihas.the “system’ “attribute set,.the message 
Files wits the ¢y SYSTEM ~ -FILE- “NOT EACCESSIBLE -< =: Me oo. eee ee 
af the = Dperamecter PAC lLe Cee, - 2 2her se et Ee i 
résodisphayedzat the- eorsole; and the edit session is aborted. Again, 


the STAT program can be used to change the system attribute, if 
desired, | | PIP EO.COM = e2ED con = e 


fo: exeFbnally; -the- Ensert mode - (<i ty ccommand allows CRI: line mba 
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7, =THE XSUB FUNCTION. 


“An additional utility program is supplied with version 2.8 of 
CP/M, called XSUB, which extends the power of the SUBMIT facility to 
include line input to programs as well as the console command 
processor, The xXSUB command is included as the first line of your 
submit file and, when executed, self-relocates directly below the CCP. 
All subsequent submit command lines are processed by XSUB, so that 
programs which read buffered console input (BDOS function 18) receive 
their input directly from the submit file. For example, the file 
SAVER.SUB could contain the submit lines: | 


SAVE 1 $2.COM 
with a subsequent SUBMIT command: 


SUBMIT SAVER X Y 


which substitutes X for $1 and Y for $2 in the command stream, The 


XSUB program loads, followed by DDT which is sent the command lines 


:. ae 
3 cr a 


“IX.HEX" “R"“ and “G#" thus returning to the CCP, The final- command 
“SAVE 1 Y.COM" is processed by the CCP. 


pone XSUB program remains in memory, ane panes the message 
| (<sub active) | 
On each warm start operation to indicate its presence, Subsequent 
submit command streams do not require the XSUB, unless an intervening 
cold start has occurred. Note that XSUB must be loaded after a a 
if both are to run simultaneously. 


i ae wo 
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8, “BDOS INTERFACE CONVENTIONS. 


zearlier versions, with a call to location 69@5H, function number in 
>register C, and information address in register pair DE. Single byte 
svalues are returned in register A, with double byte values returned in 
BL’. (for reasons of compatibility, register A = L and register B=H8 
pon. oe in all.cases). A list of CP/M 2.9 calls is given below, 


CP/M 2.8 system calls take place in exactly the same manner as 


cwith | asterisk following slag oseerengase which are either new or revised 
t£rom aruiae 1.4 to.2.9. Note. that. .a zero value is returned for 
S6UE=of range. function numbers... 1:2. | 
0. System Reset AELZ19* Delete File 
1 Console Input = .. 557 28 Read Sequential 
2 Console Output § 25:.25: Write Sequential 7 
% 3 Reader Input. i 22* Make File © | a“ 
ll 7.) 4 Punch Output Ge 23* Rename File : 
a2 5 List Output SAVE24* 2Beturn Login Vector 
Sy" -6*® Direct Console I/0 25. Return Current Disk 
with 2 gusGetul/Q Bytel > commern<:26 Set DMA Address . 
8 Set I/O Byte... ._. .27 Get Addr (Alloc) 
9 Print String ~~ SUEMIT28*# VWrite.Protect Disk 
_10* Read Console Buffer | § 29* Get Addr(R/O Vector) 
which’ Ab: sGet-Consolé-Status-: <= 34* Sét-Pile -Attributes 


XSOB .22*cReturn:Version-Number -31*:Get-Addr(Disk Parms) - 
“IX JEOL3 “Reset<Disk' System:=:.:-732% Set/Get-User Code 


"SAVE 14: SelectzDiskce:s24 2+ 27:33* 2Read Random 
...15* Open File — _ 34* Write Random 
mm  --  bhe GlosesFiles- remeins in3S#:.€omoute-File Size 
~~~ 17* Search for First 36* Set Random Record _ i. 
18* Search for Next (RSS eccive | 


ofPunctions: 28;229,-and: 342-should- be- caveided -in- application programs to 
sMaintain-upward- oe with. kleis, ) Ene new Or revised functions 
a care described beiGws:< scot Wes Pe: 


o-. - 
oe =o ROU a — am Ow ~~ ao wm ae 


‘\ | , 
Function 6: Direct Console I/O. 


7 Direct Console I/0 is supported under CP/M 2.98 for those 
“applications where it is necessary to avoid the BDOS console I/O 
operations, Programs whicn currently perform direct I/O through the 
BIOS should be changed to use direct I/O under BDOS so that they can 
be eh Supported under future releases of MP/M and CP/M. 


Upon entry to function 6, register E eitner contains hexadecimal 
FF, denoting a console input request, or register E contains an ASCII 
character, If the input value is FF, then function 6 returns A = §G 
if no character is ready, otherwise A contains the next console input 
character, | 


If the input value in &£ is not FF, then function 6 assumes’ that 
E contains a valid ASCII character which is sent to the console, 
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Furiction 18: Read Console Buffer. 


The console buffer read operation remains unchanged except that 


(} console line editing is supported, as described in Section 2. Note 


also that certain functions which return the carriage to the leftmost 
position (e.g., ctl-X) do so only to the column position where the 
prompt ended (previously, the carriage returned to the extreme left 
margin). This new convention makes operator data input and line 
correction more legible. | 


Function 12: Return Version Number, 


Function 12 has been redefined tc orovide information which . 


allows version-independent programming (this was previously the "lift 


head" function whicn returned HL=8908 in version 1.4, but performed no 
operation). The value returned by function 12 is a two-byte value, 


with H = 96 for the CP/M release (H = @1 for MP/M), and L = 69 for all 


releases previous to 2.9. CP/M 2.0 returns a hexadecimal 20 in 
register L, with subsequent version 2 releases in the hexadecimal 
range 21, 22, through 2F. Using function 12, for example, you can 
write application programs which provide both sequential and random. 


-access functions, with random access disabled when operating under 


early releases of CP/M, 


In the file operations described below, DE addresses a file 


am COntrol block (FCB). Further, all directory operations take place in 
\ja- reserved area which doés not affect write buffers as was the case in 


“version 1.4, with the exception of Searcn First and Search Next, where 
compatipility is required. , 


. 


The File Control Block (FCB) data area consists cf a sequence of 33 


bytes for sequential access, and a series of 36 bytes in tne case that 


the file is accessed randomly. The default file control plock 
normally located at JW5CH can be used for random access files, since 
bytes #8497DH, YO7EH, and O@7FH are available for this purpose. for 
notational purposes, the FCB format is shown with the following 
fields:. | | 
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oo 00 0162 ... 8 69 19 111213 1415 16 ... 31 32 33 34 35 my 
where 4 
dr drive code (J - 16) 


£1...£8 


t1,t2,t3 


ex 


52 


re 
i ce dg. e edn 


. Or. 


2 £8,r1,r2 


reserved for internal system use a Se 


§ => use default drive for file 
1 => auto disk select drive A, 
2 => auto disk select drive B, 


16=> auto disk select drive P. 


contain the file name in ASCII 
upper case, with high bit = @ 


contain the file type in ASCII 
upper case, with high bit = @g 
tl’, t2', and t3' denote the 

bit of these positions, 

tl* = 1 => Read/Only file, 

t2° = 1 => SYS file,’ no DIR list 


contains the current extent number, 
normally set to 00 by the user, but 
in range @ - 31 during file I/O 


reserved for internal system use, set. 
to zero on call to OPEN, MAKE, SEARCH 


record count for extent "ex," 
takes on values from @ - 128 


filled-in by CP/M, reserved for 


| system use 


current record to peed: or write in 
a seguential file operation, normally 
set to zero by user 


optional random record number in the 
range 8@-65535, with overflow to rZ, 

r9,rl constitute a 16-bit value with. 

low byte r@, and high byte rl — 


ot 


Function 15: Open File, 


.The Open File operation is identical to previous definitions, 


with the exception that byte s2 is automatically zeroed. Note that 
previous versions of CP/M defined this byte as zero, but made ne ) 
| 7 sata 
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_cnecks to assure compliance. - Thus, the byte is cleared to ensure 
upward compatibility with the latest version, where it is required. 


Punction 17: Search for First, 


Search First scans the directory for a match with the file given 
by the FCB addressed by DE, The value 255 (hexadecimal FF) is 
returned if the file is not found, otherwise a value of A equal to @, 
1, 2, or 3 is returned indicating the file is present, In the case 
that the file is found, the current DMA address is filled with the 
record containing the directory entry, and the relative starting 
position is A * 32 (i.e., rotate the A register left 5 bits, or ADD A 
five times). Although not normally required for application programs, 
the directory information can be extracted from the buffer at this _ 


position, > | 7 


An ASCII guestion mark (63 decimal, 3F hexadecimal) in any 
position from fl through ex matches the corresponding field of any 
directory entry on the default or auto-selected disk drive. If the dr 
field contains an ASCII question mark, then the auto disk select 
function is disabled, the default disk is searched, with the search 
function returning any matched entry, allocated or free, belonging to 
any user number, This latter function is not normally used by 
application programs, put does allow complete flexibility to scan all 
current directory values. If the dr field is not a question mark, the 
S2 byte is automatically zeroed. 3 


Function 18: Search for Next. 


The Search Next function is similar to the Search First 
function, except that the directory scan continues from the last 
Matched entry. Similar to function 17, function 18 returns the 
decimal value 255 in A when no more directory items match. | 


Function 19: Delete File, 


~The Delete File function removes: files which match the FCB 

addressed by ODE, The filename and type may contain ambiguous 
references (i.e., question marks in various positions), but the drive 
select code cannot be ambiguous, as in the Search and Search Next 
functions, rn Es er eee 


Function 19 returns a decimal 255 if the reference file or files 
could not be found, otherwise a value in the range B to 3 is returned, 
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Function 22: Make File, 


The Make File operation is identical to previous versions of 
CP/M, except that byte s2 is zeroed upon entry to the BDOS. | ) 


ie 
ae 


Function 23: Rename File. 


The Actions of the file rename functions are the same as 
Previous releases except that the value 255 is returned if the rename 
function is unsuccessful (the file to rename could not be found), 
otherwise a value in the range g to 3 is returned, 


Function 24: Return Login Vector. 


The login vector value returned by CP/M 2.9 is a 16-bit value in 
HL, where the least significant bit of I corresponds to the first 
drive A, and the high order bit of g corresponds to the sixteenth 
drive, labelled P, Note that compatibility is maintained with earlier 
releases, since registers A and L contain the Same values upon return, 


ve ‘ vo s - 


Function 28: Write Protect Current Disk. 
....° The disk write protect function provides temporary write’ 
_\. ‘protection for the currently selected disk. Any attempt to write to _/. 
the disk, before the next cold or warm start Operation produces the’ _ 
message | | | 


Bdos Err on d: R/O 


jee . Function 29: Get R/O Vector. 


. Function 29 returns a bit vector in register pair HL which 
indicates drives which have the temporary read/only bit set. Similar 
. to function 24, tne least Significant pit corresponds to drive A, 
while the most significant bit corresponds to drive P. The R/O bit is 
. Set either by an explicit call to function 28, or by the automatic: 
~ software mechanisms within CP/M which detect changed disks, . 


aT 
_e 


Function 38: Set File Attributes, 


The Set File Attributes function allows programmatic 
manipulation of permanent indicators attached to files, - In 
Particular, the R/O and System attributes (tl' and t2' above) can be 
Set or reset, The DE pair addresses an unambiguous file name with the - 
appropriate attributes set or reset. Function 38 searches for =. ) 


} 
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match, and changes the matched directory entry to contain the selected 
indicators, Indicators fl' through £4' are not presently used, but 


may be 
jin the matching process during 
Indicators 
expansion, 


useful for applications programs, since they are not involved 
file open and close operations. 
£5" through £8° and t3' are reserved for future system 


Function 31: Get Disk Parameter Block Address. 


The address of the BIOS 


resident disk parameter block is 


returned in HL as a result of this function call. This address can be 


‘used f 


Or either of two purposes, 


First, the disk parameter values can 


Be extracted for display and space computation purposes, or transient 

programs can dynamically change the values of current disk parameters 
.~ when the disk environment changes, if required, Normally, apvolication 

programs will not require this facility. —_ : 


Function 32: Set or Get User Code, 


active 


An application program can change or interrogate the currently 


user number by calling 


Function 32, If register £— = FF 


nexadecimal, tnen the value of the current user number is returned in 
register A, where the value is in the range 9 to 3l. If register E is 
BP, (then the current user number is changed to the value of £ 


=~} (Modul 


Dlace at a particular record number, 
constructed from the three byte 


Function 33: Read Random. 


of fhe Read Random function is similar to the sequential file read 
Operation of previous releases, except that the read operation takes 


selected by the 24-bit value 
field following the FCB (byte 


positions r@ at 33, rl at 34, and r2 at 35). Note that the sequence 
bits is stored with least significant obyte first (r¥), middle 
byte next (rl), and high byte last (r2). CP/M release 2.3 does not 
reference byte r2, except in computing the size of a file (function 
Byte r2 must be zero, however, since a non-zero value indicates 


of 24 


35). 
-overfl 


Ow past the end of file, 


_Thus, in version 2.8, the r¥,rl byte pair is treated as a 


double=byte, or "word" value, 


value 
record 
random 


ranges from #@ to 65535, 
of the 8 megabyte file. [In 
access, the base extent 


which contains the record to read. This 


Droviding access to any particular 
Order to process a file using 
(extent 9g) must first be opened. 


Although the pase extent may or may not contain any allocated data, 


tnis 
is vis 


the : 


ensures tnat the file is oro 


perly recorded in the directory, and 


ible in DIR requests. The selected record number is then stored 


—~into the random record field (r@,rl), and the BDOS is called to read 


ecord, Upon return from the call, register A either contains an 


(All Information Contained Herein is Proprietary to Digital Research.) 


&@ 


17 


error code, as listed below, or the value 39 indicating the operation 
was successful. In the latter case, the current DMA address contains 
the randomly accessed record. Note that contrary to the sequential , 
read operation, the record number is not advanced. Thus, subsequent ; 
_Eandom read operations continue to read the same record, : 


pare 


Upon each random read operation, the logical extent and current 
record values are automatically set. Thus, the file can be 
Seguentially read or written, starting from the current randomly - 
accessed position, Note, however, that in this case, the last 
randomly read record will be re-read as you switch from random mode to 

“sequential read, and the last record will be re-written as you switch 
to a seguential write operation. You can, of course, simply advance 
the random record position following each random read or write to 
obtain the effect of a sequential I/O operation, 


aa? 
° 


- Error codes returned in register A following a random read are 
listed below. | 


91 reading unwritten data 
@2 (not returned in random mode) 
63 cannot close current extent. 
. @4 seek to unwritten extent 
- 65 (not returned in read mode) 
=. — @6 seek past physical end of disk 
Error code §1 and #4 occur when a random read operation accesses a 
data block which has not been previously written, or an extent which — 
has not been created, which are equivalent conditions. Error 3 does ; 
‘..not normally occur under proper system operation, but can be cleared’ - 
‘by simply re-reading, or re-opening extent zero as long as the disk is 
not physically write protected, Error code 06 occurs whenever byte r2 
is non-zero under the current 2.0 release. Normally, non-zero return 
codes can be treated as missing data, with zero return codes 
. indicating operation complete, | 


ee ge 


Function 34; Write Random, 


| The Write Random operation is initiated similar -to the Read 
“Random call, except that data is written to the disk from the current 

DMA address. Further, if the disk extent or data block which is the 

target of the write has’ not yet been allocated, the allocation is 
performed before the write operation continues. As in the Read Random 
Operation, the random record number is not changed as a result of the 

write, The logical extent number and current record positions of the 

file control block are set to correspond to the random record which is 

being written. Again, sequential read or write operations can 
commence following a random write, with the notation that the 
currently addressed record is either read or rewritten again as the 
Sequential operation begins. You can also simply advance the random 

record position following each write to get the effect of a sequential 

write operation, Note that in particular, reading or writing the last | 

em record of an extent in random mode does not cause an automatic extent 
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Switch as it. sae ae ne mode under either CP/M 1.4 or CP/M 
2.0. oe See | | 


= Cn a see 


e 


_ tha ‘The error codes returned by a “random write are identical to the 
‘*vandom read operation with the addition of error code J5, which 
indicates that a new extent cannot be created due to directory 
overflow. — | | 


| lie aa ae a oe. a3 Oy orne peg ee ee 


ee. a Coy e vor c= > ~» eo o 
- - -. rd ° me : 


ne Function 35: Compute File Size. 

oe When. computing ene Size of a file, the DE register pair 
addresses . an -FCB_-in.-random mode format (bytes r@, rl, and r2 are 

present). . The ECB. contains ‘an unambiguous file name which is used in 
the ‘directory scan~ Upon ‘return, the random record bytes contain the 
“virtual”. file size which is, in.effect, the record address of the 
record . “Eollowing ~ the énd “of” thé ~ file. if, following a call to 
function 35, the high record byte r2 is dl, then the file contains the. 
maximum record count 65536 in version 2.8. Otherwise, bytes r@ and rl 
constitute a 16-bit value (rg. is the. least significant byte, as 
before) which is the chile size. 2. oe —_ 7 


- 
- 


© ih ey Ky 
Yo wr 


- - - - 
- * — 
een} fw 7 he — mae ww 


4 
- = 2: ~~ . 


A be! 


file, then Bereta “a “sequence “Of random wees Starting. at the 
preset Record ‘address, ---..- .-c- = ac 


Gate a Pike a in Sole 
7 aa nee ;Bhe virtual. size of.a- file corresponds to the physical size when 
ym) the .file .is written. “sequentially. If, instead, the file was created 
in, Eandom mode and “holes exist in- the allocation, then the file may 
infact: contain ‘fewer records — than the size indicates. If, for 
example, - only che last record of an eight megabyte file is written in 
random mode (ic.e,, record number 65535), then the virtual size is 


Rare seer although only one block of data is actually allocated. 


~~ — . 


Function 36: Set Random Record. 


‘N 


The -Set Random -Record function causes the BDOS to automatically 
produce the random record position from a file which has been read or 


written. sequentially to a particular point, The function can be 
useful . in two-ways, [ee 
s DOr oe eS, See ee ee : 
oner-First, it. is. ‘often ‘necessary to initially read and scan a 


sequential- -£file.to.extract-the positions of various “key" fields. As 
each.key is encountered, function 36 is called to compute the random 
record position for the data corresponding to this key. If the data 
unit- size is 128 bytes, the. resulting record vosition is placed into a 
table with the key for later retrieval, After scanning the entire 
file. and tabularizing the keys and their record numbers, you can move 
instantly » to.a particular keyed record by performing a random. read 
using the corresponding random record number which was saved earlier. 
wm. The scheme is easily generalized when variable record lengths are 


ep oe -. 
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involved since the - program need only store the buffer-relative byte 
~ position along with the key and record number in order to find the 
exact starting position of the keyed data at a later time. ) 


~or-- A’ second use .of function 36 occurs when switching from a 
-Ssequential read or write over to random read or write. A file is 
- sequentially accessed to a particular point in the file, function 36 
is called which sets the record number, and subsequent random read and 
write operations continue from the selected point in the file. 


r an - eo a be aT ee 
Bet Se eek ees -_— ~-—- ¢ ey te! es -~- we fs ~~ owes , 


«This: section is: concluded with a rather extensive, but complete 
a@xample. of::‘random access: operation. The: program listed below performs 
+ Pithe:: simple. function of: reading Or: writing. random records upon command 
Citron - the:> terminal. -=° Given-: that. the “program has been created, 

" wssembled,--and-- placed. into a file: labelled RANDOM.COM, the CCP level 
-£ SOMMandss-- ce inl rne |ene | 


bee gaan 


a Nes ee ne male ae ee 


~~, 
a 
— « — 
_ = = Pan 
ae” 


funcrior ti. cre | a “ Pe. eae Z 
we am ww 7 w Sa com: - mot cows Sis & mee w 
St tee Fe 88 ge tae ee cae! . . 
Ma XxX: ii. tea a ee Se a _- t ~ 
oa we ae a ae oe ww wwe eS we wt te Ne vote Net wet ‘. = 
« < -_ «. 7 a aae oe - om i “sa ( r _— = . Feglicod os eto 
constitute Z wae Veue= ee Ss ene L62s7 iS 


Dosebarts ‘thectest program: <The. program looks for a file by the name 
X.DAT (in this particular case) and, if found, proceeds to prompt the 
console: ors inputs = offc not: found,2n the: file’: “4s. “created before the 

Ccprbmet is:given. Each: prompt: takes: the form: - pamper . = 


Pile, Nek  SSric isis 2. Sesverce ce ence Koes 2M - 
preset recorc aacress, next command?» 
and is: followed. by: operator: input, : terminated: by ' carriage return.  \ 
Y~ ¢@Mer input: commands take:the: form ‘*!, :nsteei. tL: Pe _ 
a. S200 OCs ene “poles” Bees Aa ere 2 ec eee = j 
ie LEC", Soot ee Seeee Sees ss nw: =" Ri" =Q Coe. ees 
- vere. 3; one” See ees SS = Se je, ee 


rwhere nis an integer: value in: the: range 9g to 65535, and W, R, and Q 

care. simple. command:: characters corresponding to random write, random 
read, and quit processing, respectively, If the W command is issued, 
the RANDOM program issues the prompt : 


De 


et m7 aoa 
— 


~ o 
4 Cr) nr 4 
e at te ~~ 


= See ae sameee 
The operator tnen responds by typing up to 127 characters. torvewed by 
a tarriage return. - RANDOM. then. writes the character string into the 
eka file--at.. record n..-.If the R. command is issued, RANDOM reads 
~£ecord number n and displays the string value at the console. If the. 
= Q command is issued, the X.DAT file is closed, and the program returns 
to the: console. command processor. In the interest of Paeveae (ok, SO. 
séhe: program: S_ not sox brief) +: thes only: error message is | 
CeCe, “5 oe Ao oe es Be leeks Ge ead meets. oa = er Ones 


2@Lror, "try: again 


em ~~ m8 ve ~ 


- ~~ ~~ - 


Ny i d 


tanis “The program begins: with ~ ans tea ie ieee on section where the 

f input: - .file. is: opened or created,= followed by a continuous loop at the 
idabel: “ready” where. the individual. commands. are interpreted. The 
udefault.. file..control block at: 805CH and the default buffer at 90890H 
os are used in all disk operations. ‘The utility subroutines then follow, 
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which contain the principal input line processor, called “readce.* 
This particular program shows the elements of random access 
processing, and can be used as the basis. for further program 
development, | | 


g RRRRKERRKKKKKKKAEKKKKKEREKRKKREKRRREKR KK KAKA RR RAR ARR 


eX # 
a ‘ ; 
7* sample random access program for cp/m 2.4 a «OS 
o% * 
ee COTTE EC TEC CCE TE ETT TCT RTT een 
org © 166h ;base of tpa 
? 
= reboot equ 9098h ;system reboot 
= bdos equ 0805h 7;Odos entry point 
; ae | | 
= coninp equ l ;console input function 
= conout equ 2 ;console output function 
= pstring equ 9 ' gprint string until ‘Ss’ 
= rstring equ 19 ;read console buffer 
= version equ 12 yreturn version number 
= openf equ 15: . ;file open function 
= closef egu 16 7Close function 
= makef equ 22 smake file function 
= readr equ 33 ;read random : 
= - writer egu 34 ;write random 
= fcb equ O8S5ch . ;default file control block 
= ranrec equ fecb+33  ;random record position 
= ranov£ equ fcot+35 ;high order (overflow) byte 
= buff equ 3089h ;buffer address 
? 
O49d = er equ §dh ;Carrilage return 
000a = 1f egu Jah ;line feed 
: NN EENARADEWREAED OREN ERS HERREe Coe cadeceneadeecannes 
Tee ek : # 
“ 0 : : : 
7* load SP, set-up file for random access . 
eX * 
; pA RRERRANKREHRERRRARRERERERREKARRRERERRRERERERERKS 
9128 31bcd 1x1 sp,stack | 


=e sme 


version 2.9? 


mvi c,version 
call bdos 
cpl 2h ;version 2.0 or better? 
jne versok | | 
; bad version, message and go back 
Lxi d,badver 
call print a 
jmo reboot 
e 
versok: 
; correct version for random access 
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epee TEES seme oe mm ee ee ee oe ce ee eee ee .- - oe ee o 


6116 deat mvi c,openf ;open default fcb 


9118 115cd xi d,fcb 
Bllbd cd959 call bdos | ar 
Blle 3c inr a? err 255 becomes zero i” i 
B1l1l£ 62376 jnz ready Segue?) 
| » | : | : 
: | ; _ cannot open file, so create it~ 
8122 gelo6 : mvi c,make£ 
8124 115cd Lxi  d,fcb 
9127 cdd50 call bdos | 
Bl2a 3c inr a | ;err 255 becomes zero 
9125 ¢2376 | jnz ready 
| : 
: : Cannot create file, directory full 
Gl2e 113ag lxi d,nospace 
, 9131 cddag ; call print a | a 
. . 8134 63999 jmp reboot ;back to ccp 
AR RR RRR RRR RRR RRR R RRR RRR AERA RRR RR ENE 
o* ® 
3* loop back to “ready” after each command ad 
ETIT IIT TIT TT TT TTT TT TTTT TTT ttt ttt TTT TTT TT ett tit ee 
> . 
: ready: ee | 
on, © file is ready for processing 
‘ a : s 4 we . i 
86137 cdedd call readcom ;read next command 
a Gl3a 227d¥ shld ranrec ;store input record? 
eo. O13d 217£6— lxi h,ranovf ah nn 
.8146 3662 : mvi m,@ .sclear high byte if set 
9142 fe5l1 cpi OQ  gquit? - 
9144 c2560 jnz notg 
| ; quit processing, close file 
6147 Beld mvi c,closef — | 
6149 115c¥d 1xi- d,fcb 
~@14e cd@56 call bdos ee 
—- O§l4£E 3c ‘ing a 7err 255 becomes @ 
8158 cab99 jz error ;@rror message, retry 
8153 c3d00 jmp reboot ;back to ccp | - 
See TTITT CITT TOTTTTTCTTTCCTT CCT TTST TTT CCTTeS TTT SOTTO SS 
g* * , | x 
: 7* end of guit command, process write — . 
e% : * 
PITTI ITITritti ttt t Tit ttt rr rr rrr ttt ttt ttt ee eet itr te 
nota: > — 
aie not the quit command, random write? 
6156 £e57 cpi "WS 
6158 c2890 == jnz notw 
_ ~~ “4 this is a random write, fill buffer until cr 
— §1 Sb 114d9d Lxi d,datmsg. a 
am 815e cddad call print ;data prompt | ) 


Tn © 
ile ce P 
babe \ wet + 
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mvi Cri27 sup to 127 characters 


lxi h,buff ;destination 
rloop: ;read next character to buff 
 pusn b ;save counter 
push - h snext destination 
call §$getchr ;character toa 
pop h s;restore counter 
pop 5b ;restore next to fill 
epi cr send of line? 
jz erlooo 
: not end, store character 
mov —,a 3 
inx h | ‘gnext to fill 
der Cc scounter goes down 
jnz rloop send vf puffer? 
erloop 
; end of read loop, store 0G 
9178 3609 mvi m,d 
a 
: write the record to selected record number 
91l7a Be22 mvi c,writer | 
@17c 115cd — Lx  d,fcb | 
Q17£ cdg5a call bdos | 
~ 9182 b7 ora a . serror code zero? 
9183 c2b96 — jnz error ;message if not 
0186 ¢c3370 jmp ready :for another record 
| III ICICI ICICI CCITT TITRE 
>* end of write command, process read : 
a, 
ICICI III COTO OOOO I IIH IIe 
notw: | | 
. : not a write command, read record? 
9189 fe52 cpi "Ro : | 
18b c2b90 jnz error ;skip if not 
| : read random record 
918e de2l | mvi c,readr 
81906 1Li5dcd 1xi d,fcb | - ee 
~~9193 cdd56 | call §bdos_. oS 3. See 
~ §196 b7 | ora a - greturn code 80? 
9197 c2b9¢ jnz error : 
a 
Pre 2 ; read was successful, write to console 
§919a cdcfd call erlf snew line 
819d Jess mui c,128 max 128 characters 
919£ 21800 1x1 h,buf£f ;next to get 
wloop: | a3 : 
Gla2 ve mov a,m snext character 
Gla3 23 inx h ynext to get 
Gla4 e67£ ; ani 7fh = ¢mask parity 
91la6 ca37 jz - ready ‘for another command if 0@ 
am Glad cS push b ;save counter 
/ Blaa e5 : push oh esave next to get 
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Glab 
Glad 
91lbg 
91bl 
B1lb2 
¥1lb3 
§1b6 


§91b9 
— §1lbe 
. O1bE 
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fe2d 
d4c84g 
el 

cl 


Od 


c2a2g 


"63370 


1159¢ 
cddag 
03370 


_ —erit: 


cpl sgraphic? 
enc putchr ;skip output if not 
pop h 
pop b , 
dcr c ;count=count-1 
jnz wloop 
jmp ready 
ITITIITITTTTETTTETTCTETTOTETESTTTTTTT TTT ETT TT TTT 
3% x 
;* end of read command, all errors end-up here x 
o & 
ETIITISTITTT TET TTITETETTITTTTCTTTTTTT TTT TTT TTT TTT 
? 
error: 
lxi d,errmsg 
call print 
jmp ready 
ST ITILITECECTTTCCETTTCTOTTO CEST TTT T ETT T CTT T TT TTT 
2x & 
;* utility subroutines for console i/o = 
eo ; ¥. 
oR KEE E EER R RRR EERE RR RRER EERE RRRR RRR ER RE ER EER RR 
getchr: 
yread next console character to a 7 
mvi c,coninp 
call bdos 
ret ; 
eee ° ae - a ote aS ee a ie eee : 
—putchr: © a Soe | 
;write character from a to console 
mvi c,conout 
mov e,a s;character to send 
call bdos send character. 
ret 
-esend carriage return line feed 
mvi a,cr ;Carriage return 
call putchr 
mvi a,lf sline feed 
call putchr 
ret 
: | 
prints 
: sprint the buffer addressed bY de until = 
push qd 
call crlf se 
pop | snew line 
mvi c,pstring 
call bdos sprint the string 
ret | oe — 
; 
readcom: 
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:read. the next command line to the conbuf 


116b9 -1Lxi d,prompt 
cddag call print > command? 
deda mv1 c,rstring 
117ag- lxi d,conbuf | 
cag5¢a call bdos sread command line 
; command line is present, scan it 
 @1£3 210090 lL xi h,@ ' sstart with 6d90 
G91f£6 117cd Lxi d,conlin;command line 
91f9 la readc; ldax d s;next command character 
Jlfa 13 inx d sto next command position 
Vlfb b7 ora a ;Cannot be end of command 
Dlfc c8 rz | 
| ; - mot zero, numeric? 
Olfd d63v sul *9 ° , 
‘@1fE feda cpi- 10 ;Ccarry if numeric 
~ $261 d213¢d jne endrd 7 
| ; add-in next digit 
§2084 29 dad h |. 3¥*2 
§2985 4d mov Cyl 
9266 44 | mov b,h sbc = value * 2 
§297 29 ; dad h 3*4 oe 
9298 29 dad h 3*8 
.8@299 69 dad b 7*2 + *8 = *18 
G2va 85 ; add 1 s+digit 
J2H0 6£ mov l,a 7 
jne readc ;for another char 
a ine h  goverflow 
a 1d c3f jmp... + readce  ;for another char 
Recs on endrds | | ne 
: 2 end of read, restore value ina 
6213 c63d adi *g’ :command 
9215 fe6l . cpl ya’ s;translate case? 
H217 da rc 
: , lower case, mask lower case bits 
9218 e65£ ani a 
“g2la cY | ret 
WITT T TIT TI TTT ITT ETT TTT TTT TIT TT TTT LiTti tert ttTTt tite. | 
eX . * 
3* string data area for console messages eos 
vee | . 
Aololotetehaieioooloieleiaieiololeleieieieloololeieieieielelolololaieleleioioialaleieleloiete 
. badvers 
O2lb 536£79 db ‘sorry, you need cp/m version aoe 
4 ss MOSpace: | 
G23a 4e6£F29 db ‘no directory spaces’ 
: datmsg: 
G@24d 547970 db ‘type data: $' 
errmsg: 
-9259 457272 db ‘error, try again.$s' 
caste, 3 prompt: 
0266 4e657G db ‘next command? so 


e 
8 
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g RRR RK EKER RE REE ERK EKER RK RRA 


| 9% | | te 
| 7* fixed and variable data area 7 . ) 
Do & oe : : " | 
' pA ARERR RHR RR RRR RRR EER EA EER EERER EERE RRR ER RRA RER EEE > 
827a 21 conbuf: db = conlen ;length of console buffer 
927b consiz: ds 1 resulting size after read 
G27c | conlin: ds 32 slength 32 buffer 
6821 = = conlen equ $~consiz 
| ; 
829c | ds 32 716 level stack 
stack: | | : : 
B2bc | end 
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and occupies 


a following section, 


ty 


oe 


9, CP/M 2.0 MEMORY ORGANIZATION, 


Similar to earlier versions, CP/M 2.0 is field-altered to fit 
‘memory sizes, depending upon the host computer memory 
configuration, Typical base addresses for popular memory sizes are 
Shown in the table below. : | 

32k 48k 


Module 20k 24k 64k 

CCP 34008 4400H 64004 A499H E460H 
~BDOS 3COUH 4C@0H 6C9 GH ACO HH ECG GH 
BIOS 4AG0H 5A@ GH 7A9 648 BAG GH FAQ 6H 
Top of Ram 4FFFH OF EFH 7PRFA BFFFH PEREEFHA 


The distribution disk contains a CP/M 2.9 system configured for a 29k 
Intel MDS-860 with standard IBM 8“ floppy.disk drives. The disk _. 
layout is shown below: ~ | 


Sector* Track d9 Module Track gl Module 
1 (Bootstrap Loader) 4980H BDOS + 480H 
2 34908 CCP + 9@0H 413@0H BDOS + 500H 
3 3486H CCP + §80H 4180H BDOS + 586H 
4 35008 CCP + 100H 4260H BDOS + 606H 
5 3589H - CCP + 18H 423¥H BDOS + 6808 
6 3606H CCP + 20GH 4300H BDOS + 700H 
12 3688H CCP + 2888 4380H BDOS + 780H 
8 37008 CCP + 360H 4494H BDOS + 800H 
] 37808 CCP + 389H 4486H BDOS + 884HH 

19 3860H CCP + 4986H 4500H BDOS + 99H 

2 ee OF 388GH CCP + 43808. 4589H BDOS + 98H 
12 39908 CCP + 590H 460¥H BDOS + AGH 

13 398648 CCP + 5896H $468@6H BDOS + A&8@H 

14 3AQ00H CCP + 600H 4700H BDOS: + BOOH 

15  3A8@H CCP + 6868 4780H BDOS + B&a@H 

16 3B8G6H CCP + 748@0H 4809H BDOS + CYOH 

17 3B80H CCP + 780H _4880H BDOS + C8@H 

18 3C96H BDOS + @00H 4960H BDOS + D@9H 

i 19. 3C8@H BDOS + §89H 4980H BDOS + D8@H 
26 3D9@H BDOS + 190H 4AG@H BIOS + GOGH 

21 3D88H BDOS + 189H 4A80H BIOS + 986H 

22 3E@@H BDOS + 206H 4800H BIOS + 19@H. 

23  3E8@H BDOS + 280H 4B8@H BIOS + 1890H 
24 3FO0H BDOS + 3908 4C@6H BIOS + 200H 

25 3F8@H BDOS + 380H 4C80H BIOS + 2808 

26 4909H BDOS + 49008 4D@9H BIOS + 390H 


In particular, note that the CCP is at the same position on the disk, 
the same space as version 1.4. The BDOS portion, 
however, occupies one more 256-byte page and the BIOS portion extends 
through the remainder of track #61. Thus, the CCP is 806H (2048 
decimal) bytes in length, the BDOS is E9OH (3584 decimal) bytes in 
length, and the BIOS is up to 38@H (898 decimal) bytes in length, In 
version 2.8, the BIOS portion contains the standard subroutines of 
1.4, along with some initialized’ table space, as described in the 
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~ 


: 16. BIOS DIFFERENCES, 


yew" from its predecesssors, Two new jump vector entry points are defined, 

a onew sector translation subroutine is included, and a disk 

“characteristics table must be defined. The skeletal form of these 
“Changes are found in the program shown below, 


The CP/M 2.6 Basic I/O System differs only slightly in concept. » 


ass — Org . . 4600h ~ | = 
Zi). saclib diskdef | ee nates 


SIO: jmp .°:- boot | 7 


7 aa raawece Pe a 
~The 6. 0885--22-2:-7- JM. See 7Bector. translate. 
= . ae disks. = 4- ee a mt . ao ” 


om 
— 
~ ee -~ moe 


layour &8% fencer _darge. capacity cre 
eee 9: bpb equ 16*1824 sbytes per block 

10 x rpb- - equ.-. - bpb/128- ; records. per block 
lis maxb equ... - -65535/rpb ;max block number 


12: - diskdef @-,1,,58,3,bpb,maxb+1.,128,0,2 
13: = diskdef 1,1, 58,4bpb, maxb+1,128,,95, 2 
. 14: , | diskdef 2,6 - ie: S050) St 
1S: diskdef 34d. _. 1555 azeve EDGE - 
- 163 5 3608E CCE - 2805 43@eE EDCS>- 
¥73 boots Sher IAOP - 2euk — 438BH BOLE - 
° ¢@;. BS tages Sa ee ee Cece, ape ee. 
19: listst: era. amr = nop pe ee 
oO ay Rehyce Con = Ades eSbas ELLs - 
21: 3. |. er Aes of gce RS ee as - 
~ “223 seldsks poise ee ee. {508 Se 
meee <a ‘drive number in. c: ea aoe 
243 -, _lxi-- h, @. 2 $0000 in hl produces select error 
253 3: Ov. - a,@ _ 23a: is disk: number 9 ... ndisks-1 
263 -- cpi.-- ndisks -;less than ndisks? 
Alees rnc o- _preturn with HL = 08008 if not 
283 ;} proper disk number, return dpb element address 
Seo 293 Ye MOVec? SeGi a oi 8 eee gee 2 
30: 4: dad: ree 3 *2 
cp ae dad: Ao: _ 734 0 
323 -- ad- Nee a. ~ 988 : : - 
33: -; daa: Pec FTES : 
343 =) lxi-- d,dpbase . sere 7 
35: °- dad. a. _ .;HL=.dpb 
363 -, ret: :. ee os eee aneay Se : 
Sie CC we eee a 
In oa 3Bs,Selseci..< -- 2 Soe CC> Be Be Sees Sees Sees... | 
anc ce ;sector number se Cue oae Le — 
ine ea anrm ee es a -h,secto S288 Fe ee ae 
nroy Al: --- =i. mov: “M,C leer. fl. Seta % 
fe) cine: reves ;Fet.---- ae SS eee ee : 
lens A 7 2Oe Se Oo Se ee ee Gee ee. ee es : 
Gere ae sectrans. --- eee wee ad ee 
a ae Cs ae > ytranslate sector. c using table at DE 


Poa -. «46s os xchg pi 


B ; 
| HL = .tran , a 
473-- dad. b si 


ngle precision tran | A ) 
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48: 3; dad b again if double precision tran 


493. mov l,m ;only low byte necessary here 
50: 3; fill botn H and L if double orecision tran 
51: ret : sHL = ??ss | 

32: °3 | 

533: sector: ds 1 

54:3 endef 

55: end 


Referring to the program shown above, lines 3-6 represent the 
BIOS entry vector of 17 elements (version 1.4 defines only 15 jump 
vector elements). The last two elements provide access to the 
“~LISTST" (List Status) entry point for DESPOOL. The use of this 
particular entry point is defined in the DESPOOL documentation, and is 


no different than the previous 1.4 release, It should be noted that 


the 1.4 DESPOOL program will not operate under version 2.90, but an 
update version will be available from Digital Research in the near 
future, : 


The “SECTRAN“ (Sector Number Translate) entry shown in the jump 
vector at line 6 provides access to a BIOS-resident sector translation 
subroutine. This mechanism allows the user to specify the sector skew 
factor and translation for a particular disk system, and is described 
below. : _ 


A macro library is shown in the listing, called DISKDEF, 

included on line 2, and referenced in 12-15. Although it is not 

fm hecessary to use the macro liprary, it greatly simplifies the disk 

- Ydefinition process. You must have access to the MAC macro assembler, 

of course, to use the DISKDEF facility, while the macro library is 

included with all CP/M 2.8 distribution disks. (See the CP/M 2.24 

Alteration Guide for formulas which you can use to hand-code the 
tables produced by the DISKDEF library). | 


A BIOS disk definition consists of the following sequence of 
macro statements: | 7 


Ne 


MACLIB DISKDEF 
DISKS n 
DISKDEF @,... 
DISKDEF l,... 
DISKDEF n-1 


ENDEP | 7 ee (f 


where the MACLIB statement loads the DISKDEF.LIB file (on the same 
disk as your BIOS) into MAC's internal tables. ‘The DISKS macro call 
follows, which specifies the number of drives to be configured with 
your system, where n is an integer in the range 1 to 16. A series of 
DISKDEF macro calls then follow which define ‘the characteristics of 
each logical disk, 9@ through n-l (corresvoonding to logical drives A 
“Sthrough P). Note that the DISKS and DISKDEF macros generate in-line 


(All Information Contained Herein is Proprietary to Digital Research.) 


29 


fixed data tables, and thus must _be placed ina non-executable portion 
of . voue BIOS, EyPACatoy a following the BIOS jump vector. 


- 


. The remaining portion of your BIOS is defined following the. 
(“\ DISKDEF macros, with the ENDEF macro call immediately preceding the 


END statement. The ENDEF (End of Diskdef) macro generates the 
necessary uninitialized RAM areas which are located above your BIOS. 


-— 


the form Of the DISKDEF macro call is 


cee: :RESKDEF - rang fsc, -iLsc;, take] cbie, dks, dir, cks, ofs, {a1 

S255 2255 pete ie . Ses =r - 

vewhere.  e-2-7-: Tee ~33: ae ees : : 

a eee wast SeStos entir Sly +225 one ce 

particuldn >" cis “the -logical ‘disk number: oO a nel ree ie ‘oe 

ne cif: fEsec.- <:ks the first. ‘physical sector number (a or l)-- oo as 
tne l.slsq@csrcis theckast sector-number--:: -: WAS te 2. eee Ae 
-apaate vEk£ ion is ‘the optional sector. ekew factor: ax, “Bee Fa, 
future. bls ls the data allocation block size 

- dir is the number of directory entries 


Baek s $=07ES:: the inumber sof “checked -directory entries i take 
vector-<afS$:n- Es -the ‘track -offset to Eogieal -track 46. at ae: 
suprou-7i fb] “onis amcoptionak: Lot scompatibrl ity - age oe: 


ed gt 
t 
oe 
{ 
} 
f 
é 
! 


PaCtor ene Sens ee cs Co te Sere icles See Shee. She te Besse ser 

pelhe . value “dn“ is the drive number being defined with this DISKDEF 
macro invocation, The “fsc" parameter accounts for differing sector 
number ing -systems.<-and - Es usually @ or-k, .:‘The: “Isc"..:is the’ last 


imumbered -sector-on Ja track. --When present, the “skf£" ‘parameter defines 
| nee = Sector - kew.< Eactor which is used to create-a ae translation 
== detable according: -to the skew... -L£-the number of sectors. _ less than 
022 SO <8 single-byte table -is -created, atherwise each ee ee table 
i element occuples two -bytes. No-translation table is. created if the 


A:SkE:-parameter is omitted {or equal to 4Q).. The “bls" parameter 
rampeciftes the number. of bytes. ‘allocated to each data block, and takes 
= On the values 10924, 2948, 4996, 8192, or 16384, Generally, 


performance - increases - with - larger - data block sizes since there are 


mekewe & - -directory references and logically connected data records are 


“physically close on the disk. Further, each directory entry addresses 
“more: data and-:the- BIGS=—resident ram space is reduced, The “dks" 


specifies the total disk size in “bls" units. .That is, if the bls = 


2048 and dks =-160%8, then the total disk capacity is 2,048,000 bytes, 
If dks is greater ‘than 255, then the block. size parameter bls must be 
greater than 1824 .:: The © value of “dir" is the total number of 


directory entries which may exceed 255, if desired, The "“cks". 


Parameter determines = the. number of directory items to check on each 
directory scan, and iis used internally to detect changed disks during 
System operation, =:where an intervening cold or warm start has not 
occurred (when this situation is detected, CP/M automatically marks 
wnthe -disk: ‘read/fonly~-so ‘that -data-~‘is not. subsequently destroyed). 
G ‘Normally - the value of. cks.:= dir -when :the media is easily changed, as 
cisc.the.case with a-floppy disk -subsystem, If the disk is permanently 
-aneunted, -then: ‘the value -of -cks -is typically @, since the probability 
~ -of - ‘changing .-disks- without. a-restart is quite low. The "ofs" value 


-— - = rs 


e determines the number of tracks -to skip when this particular drive is 


— & ee a ae eer ee) 
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ae 


addressed, which can be used to reserve additional eRerereng system 


ae ~~ ee ee oe. re eee, 


space or to simulate several logical drives on a single large capacity 
physical drive, Finally, the [@] parameter is included when file 


—\compatibility is required with versions of 1.4 which have been 


yn nontneas for higher density disks, This parameter ensures that only 


a DISKDEF 


f ~*~ 
: F 


16K is allocated for each directory record, as was the case for 
previous versions. Normally, this parameter is not included. | 


For convenience and economy of table space, the special form 
DISKDEF i,j 


gives disk i the same characteristics as a previously defined drive j. 
A standard four-drive Single density system, which is compatible with 
version 1.4, is defined using the following macro invocations: 


DISKS 4 
9,1,26,6,1924,243,64,64,2 
DISKDEF Ll, 
DISKDEF 2% 
DISKDEF 3, 


ENDEF 


with all disks having the same parameter values of 26 sectors per 
track (numbered 1 through 26), with 6 sectors skipped between each 
access, 1024 bytes per data block, 243 data blocks for a total of 243k 


crm, byte disk capacity, 64 checked directory SRECLES and two operating 
™ysystem tracks, - - ee 


— 


The definitions given in the program shown above (lines 12 
through 15) provide access to the largest disks addressable by CP/M 
2.9. All disks have identical parameters, except that drives @ and 2 
skip three sectors on every data access, while disks 1 and 3 access 
each sector in sequence as the disk revolves (there may, however, be a 
transparent hardware skew factor on these drives). 
| The DISKS macro generates n “disk header blocks," starting at 
address DPBASE which is a label generated by the macro. Each disk 
header block contains sixteen bytes, and correspond, in sequence, to 
each of the defined drives, In the four drive standard system, for 
example, the DISKS macro generates a table of the form: 


DPBASE EQU $ 

‘DPE@: DW XLT@,0000H,0000H,0000H,DIRBUF,DPBO,CSVG,ALVS 

DPE: DW. XLT#,0000H,0000H,0000H,DIRBUF,DPBO,CSV1,ALV1 
DPE2: DW XLTS,6900H,0009H,9000H,DIRBUF ,DPBO,CSV2,ALV2 

DPE3: DW  XLT9,0900H,0009H,0000H,DIRBUF ,DPBS,CSV3,ALV3 


where the DPE (disk parameter entry) labels are included for reference 
purposes to show the beginning table addresses for each drive §@ 
through 3. The values contained within the disk parameter header are 


described in detail in the CP/M 2.9 Alteration Guide, but basically 
address the translation vector for the drive (all reference XLTO@, 


(which is the translation vector for drive @ in the above example),: 


- 
S 
= 
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followed by three 16-bit "“scratch" addresses, followed by the 


directory buffer address, disk parameter block address, check vector 
address, and allocation vector address, The check and allocation 


vector addresses are generated by the ENDEF macro in the ram area. 


pees the BIOS code and tables. 


“The SELDSK €unction is extended somewhat in version 2.9. In 
particular, the selected disk number is passed to the BIOS in register 


C, as before, and the SELDSK subroutine performs the appropriate 


software or hardware actions to select the disk. Version 2.4, 
however, also requires the SELDSK subroutine to return the address of 
the selected disk parameter header (DPE, DPE1, DPE2, or DPE3, in the 


above example) in register dL. If SELDSK returns the value HL = 


9@00H, then the BDOS assumes the disk does not exist, and prints a 
select error mesage at the terminal. Program lines 22 through 36 give 


a sample CP/M 2.8 SELDSK subroutine, Showing only the disk parameter 


header address calculation, 


| The subroutine SECTRAN is also inetuaee: in version 2.9 which 
performs the actual logical to physical sector translation. In 
earlier versions of CP/M, the sector translation process was a part of 


the BDOS, and set to skip six sectors between eacn read. Due 


U 


differing rotational speeds of various disks, the translation function 
has become a part of the BIOS in version 2.9. ‘Thus, the BDOS sends 
sequential sector numbers to SECTRAN, starting at sector number 49. 
The SECTRAN subroutine uses the sequential sector number to-produce a 
translated sector number which is returned to the sBDOS. The BDOS 
Subsequently sends the translated sector number to SELSEC before the 


| actual read or write is performed, Note that many controllers have. ~. 
‘“ the capability to record the sector skew on the disk itself, and thus 
there is no translation necessary, In this case, the “skf" parameter -~ 


is omitted in the macro call, and SECTRAN simply returns the same 
Value which it receives, The table Shown below, for example, is 
constructed when the standard skew: factor skf = 6 is specified in the 
DISKDEF macro call: | 


XLTO@: DB 1,7,13,19,25,5,11,17,23,3,9,15,21 


oe "DB 2,8,14,20,26,6,12,18,24,4, 10, 16,22 wns pb ee 


a aaie - 


If SECTRAN is required to translate a sector, then the ere 
process takes place, The sector to translate is received in register 
pair BC. Only the C register is significant if the sector value does 


not exceed 255 (B = 66 in this case). Register pair DE addresses’ the 
sectcr translate table for this drive, determined by a previous call 


On SELDSK, corresponding to the first element of a disk parameter 
header (XLTO in the case shown above). The SECTRAN subroutine then 
fetches the translated sector number by adding the input sector number 
to the base of the translate taple, to get the indexed translate table 
address (see lines 46, 47, and 48 in the above program). The value at 
this location is then returned in register L. Note that if the number 
of sectors exceeds 255, the translate table contains 16-bit elements 
whose value must be returned in HL. | See hs 


Following the ENDEF macro call, a number of uninitialized data — 
areas are defined. These data areas need not be a part of the BIOS 
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ied _ 4 ie 
Se ieee 
. 


~ - 
FAT me 
oe me me 


witfett “fs eagad upon cold start, but must be available between the 
BFOS ‘arid ‘the end of memory. The size of the uninitialized RAM area is 
, determined by EQU statements generated by the ENDEF macro. For a 
: standard four-drive Syercme the ENDEF macro might Oroduce 


Tone oe 


: | “4072 = BEGDAT EQU $ 
partic. | (data areas) 
~;. €£ ' 4pBg = ENDOAT EQU $ 
SOftw2°:°g13c = DATSIZ EQU $-BEGDAT 


Noweve. 


witith Sindicates that uninitialized RAM begins at location 4C72H, ends 
a&>4pBeH-1, and occupies ¥g13CH bytes. You must ensure that these 
addtésses are free for use after the system is loaded, | 


“TSEelecr: 


sco WA AOa oak 2. et sig es tadinko «GS ati abs <ih gd ean sie ani ions P* Seoag Xap . 


é  S&Ip/M 2.0 is.also easily adapated to disk subsystems whose sector . 


sbfeCES a multiple of 128 bytes. Information is provided by the BDOS 
On sector write operations which eliminates the need for pre-read 


operations, thus allowing blocking and deblocking to take place at the 


BEGS ‘Tével. 
@4ariie: 


toe ee the “CP/M 2.0 Rieeeneion Guide“ for additional details 
eéndéfring tailoring ioe CP/M system to your particular hardware. 
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